(Format Conversion Piecemeal): Clarify

`after-insert-file-functions' calling convention.

diff --git a/lispref/files.texi b/lispref/files.texi
index 730b2b9b49742c83bab8bb819cb23efb01c2b56b..659229681b9cf312b00ea94ccb7b50f4902fbc3c 100644 (file)
--- a/lispref/files.texi
+++ b/lispref/files.texi
@@ -3071,8 +3071,10 @@ have been dealt with by this function.
 
 @defvar after-insert-file-functions
 Each function in this list is called by @code{insert-file-contents}
-with one argument, the number of characters inserted, and should
-return the new character count, leaving point the same.
+with one argument, the number of characters inserted, and with point
+at the beginning of the inserted text.  Each function should leave
+point unchanged, and return the new character count describing the
+inserted text as modified by the function.
 @c ??? The docstring mentions a handler from `file-name-handler-alist'
 @c     "intercepting" `insert-file-contents'.  Hmmm.  --ttn
 @end defvar